home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / indent.arc / INDENT.DOC next >
Encoding:
Text File  |  1985-10-06  |  3.8 KB  |  83 lines
  1.  
  2.  
  3.                              INDENT.PRG V3.5
  4.  
  5.         This program was designed to make editing your  dBase  program 
  6.         files  easier.  Now  you  will  no  longer need to worry about 
  7.         keeping program indentions 100%  correct  to  facilitate  easy 
  8.         reading later on.  
  9.  
  10.         Please note:  this version has had some bugs removed that were 
  11.         found in the earlier versions.  If you have  old  versions  of 
  12.         indent, you may wish to remove them.  
  13.  
  14.         Some  notes on indent:  Indent.prg requires an additional file 
  15.         to function, called indent.dbs.  Indent.dbs is a database file 
  16.         created  by  typing CREATE INDENT.DBS (that's right,  .DBS not 
  17.         .DBF). The structure for this file is shown below: 
  18.  
  19.                 Structure for database : C:INDENT.DBS
  20.                 Number of data records :       0
  21.                 Date of last update    : 08/14/85
  22.                 Field  Field name  Type       Width    Dec
  23.                     1  LINE        Character    254
  24.                 ** Total **                     254
  25.  
  26.         Indent will also leave a note behind as to  when  the  program 
  27.         file  was last updated if you wish for it to.  This is done by 
  28.         adding the line: 
  29.  
  30.                 **  LAST UPDATE: 00:00:00 00/00/00 
  31.  
  32.         to your program.  Each time you run indent,  it will  put  the 
  33.         system date and time into this line. This feature was added to 
  34.         keep track of mutiple versions of any particular program.  
  35.  
  36.         Indent  will indent any filename,  with any extention.  But if 
  37.         you do not speciy an extention,  indent will automatically add 
  38.         .PRG to the end of the filename.  
  39.  
  40.         Indent  also  generates  a  .BAK  file  when it indents,  that 
  41.         contains a copy of  your  program  as  it  sat  before  indent 
  42.         started working on it.  If indent it interrupted, the lines in 
  43.         your program file will basically  turn  into  garbage.  Indent 
  44.         cannot  be  interrupted  using  the  escape  key  once  it has 
  45.         actually begun indenting your file because of  the  damage  to 
  46.         your program file this would cause.  
  47.  
  48.         Indent adds space characters to the beginning of all the lines 
  49.         it is indenting. Each of these space characters takes 14/10000 
  50.         of a second to be processed by dBase.  FOR THIS REASON, PLEASE 
  51.         DO NOT RE-INDENT THE INDENT PROGRAM FILE.  Indent has been re-
  52.         written many times with just one objective, speed. Indent used 
  53.         to take 1.8 seconds (average) to process one line of text from 
  54.         our original test program file. Indent now takes 0.366 seconds 
  55.         to process the same line of code.  (Please note that the speed 
  56.         of the indent program depends on the average  length  of  each 
  57.         line of text in the program file as well as the average number 
  58.         of spaces of indention in the program file.  Your 'seconds per 
  59.         line' results will be  different  for  that  reason.  we  have 
  60.         found  it  much  more  reasonable to expect .5 to .6 sec/line. 
  61.         These times were run with an AT&T PC6300.) 
  62.  
  63.         If you re-indent indent,  you will slow execution time by  10-
  64.         30%.  To  increse  program speed another 5%,  remove the "'at' 
  65.         14,8 say recn()" line from the program.  
  66.  
  67.         One last word on speed, processing only the first 4 characters 
  68.         of a command speeds program execution time by 10%, that is why 
  69.         the code looks so strange.  THIS PROGRAM,  RUN ON A 1200  LINE 
  70.         PROGRAM  FILE,  NOW  TAKES APROX 11 MINIUTES (ON AN AT&T 6300) 
  71.         ORIGINAL RUN-TIME WAS 51 MINIUTES (ON AN AT&T 6300). Depending 
  72.         on the width of the original indentions,  a 100  line  program 
  73.         can take less than 1 miniute.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.